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1. Introduction to Workload Management 


Workload Management is a new feature in IBM Integration Bus V9 which allows system administrators to 
monitor and adjust the speed that messages are processed, as well as controlling the actions taken on 
unresponsive flows and threads. Unresponsive flows will be covered in another lab. 


The following topics explain the various options available under workload management: 
Message flow notification 


A common requirement is to be able to monitor the speed at which IBM Integration Bus processes 
messages. Workload management allows the system administrator to express a notification threshold for 
individual message flows deployed. An out of range notification message is produced if the notification 
threshold is exceeded. A back in range notification message is produced if the notification threshold later 
drops back into range. 


Setting the maximum rate for a message flow 


The system administrator can set the maximum rate that an individual message flow can run at. The 
maximum rate is specified as the total number of input messages processed every second. When set, the 
number of input messages that are processed across the flow is measured. This measure Is irrespective 
of the number of additional instances being used, the number of input nodes in the message flow, or the 
number of errors that occur. If necessary, a processing delay is introduced to keep the input message 
processing rate under the maximum flow rate setting. 


Unresponsive message flows 


Allows you to specify and monitor the maximum amount of time that any message flow is allowed to 
process a message for, and to specify an action to be taken if the timeout is exceeded. Additionally, 
manual requests can be made to stop a message flow by restarting the execution group. 


This lab will cover throughput control of messages flows - message flow notification and setting the 
maximum rate for a message flow. The following lab will cover unresponsive message flows. You do not 
need to complete this lab before beginning the unresponsive message flows lab. 
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2. An example of Workload Management 


This example demonstrates how an IBM Integration Bus administrator can control the rate at which 
message flows process data without redesigning the message flow. 


The default behaviour of a message flow is to process work as fast as possible, with no delay between 
messages or records. If a message flow calls a back-end system during its processing, and the message 
flow receives an unexpectedly high volume of work, the back-end system might be put under 
unexpectedly high load. 


Using this sample, you can demonstrate how using Workload Management features on the outbound 
message flow can limit the rate at which the message flow is processed, and so avoid overloading the 
back-end application. 


This sample uses a small Java application which simulates a real-time backend system invoked via 
TCP/IP. The broker provides a batch interface to that application via files - the file is CR-LF delimited and 
contains a lot of records. The broker reads files from an input directory and sends each record to the 
backend TCP/IP application. It receives TCP/IP responses and appends them to another file. Using a 
large file as input to the flow allows a workload to be simulated which will run for long enough to observe 
the processing rate. 


The backend program is designed to simulate a system which will not handle being called at a high rate, 
and will also show the rate at which it is being called. 


Producer Message Flow 


Input file | Workload 
Management 
Policy 
Back-end 
Application 
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2.1 Setup the environment 


1. The environment for this lab has already been configured for you on the VMware image. 
The Workload Management Sample application uses the Filelnput Node for starting the 
message flow. This requires the environment variable 


MQSI_FILENODES ROOT DIRECTORY=C:\WLMSample 


The directory for the file nodes has already been created. The environment variable 
designates C:\WLMSample as the root which has subdirectories fileinout and fileoutput. 
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2.2 
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Import the Application 


If not open, start the Integration Bus Toolkit by double-clicking its desktop icon 

For the Toolkit, use the workspace c:\workspaces\IBWorkshop or you may use your 
existing workspace. 

If not open, start the IB Explorer by double-clicking its desktop icon (MQ Explorer). 


If you receive the welcome pane, click the arrow on the top right to exit the Welcome screen. 


In the toolkit’s lower left, in the Integration Node’s view, ensure that the IB9NODE is started. 
If it is stopped, start it by right-clicking IB9NODE, then selecting Start. 


Right-click in the white space of the Application Development navigator, and select Import. 


On the Import Select panel, expand Other by clicking the plus sign and select Project 
Interchange. 


Click Next. 
Click Browse and navigate to C:\student\Workload_Management\resources\. 
Click WLMSample.pi.zip. 


On the Import Projects panel, the two projects should already be checked. Click Finish. 








{8 Import Project Interchange Contents 7 = [oO] x| 
Import Projects i" 
Import Projects from a zip file. ! 
= all 
From zip file: C:\student\Workload_management\esources\WLMS *] Growse... | 






Project location root: | C:\student\Workload_management\workspace 





t= Run_slow_tcpip_app 
[= WLMSample_ProductSales 


Select All| Deselect All | Select Referenced | 


(?) < Back | Next = || Finish | Cancel | 
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The application, BAR file, and other resources are now imported and displayed in the 
Application Development navigator. 


(8 Integration Development - IBM Integration Toolkit - 


| wi | 2 | oe | ee. @-' 
“epiatonde, Ei fateretiow | = 





Application Development 


+] AA) WLMSample ProductSales 


fii] BARS 
Ete Independent Resources 
[= Run_slow_tcpip_app 
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2.3 Deploy the application 
1. Create a new integration server (execution group) by right clicking on IB9NODE and 
selecting New Integration Server. 


——!| 





&° Refresh 





2 Delete 





2. Name the Integration Server WorkloadManagement, and click OK. 


Note — the name of the new server is case-sensitive, since some scripts provided later in the 
lab reference the server name. 





10 New In tegration Server X| 
Enter the name of the new integration server: 
WorkloadManagement| 
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3. Deploy the application by right-clicking on WLSample_ProductSales and selecting Deploy. 


_= ———— a F - Se =e 
——— a | '" 7 ——————EEEE 5 * ‘ = 1 : ee a om | | eee m 
eu) ADDICaDON VEVEOpmMmeENnT x * L-, Fatierns EXDIOrer 











Application Development 
Sree LMSample_ProductSaleg 
EI Independent Resources 
F)- Run_slow_tcpip_app 


Select the WorkLoadManagement server and click Finish. 


Deploy 


Select integration server to deploy selected resources. 
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2.4 Start the monitor application 


The Workload Management sample programs allow a pair of message flows (within an Integration Bus 
Application) to be driven as fast as they will go for a short time, using a large file. The back-end program 
gives an indication of the message rate being achieved by the flows. The main point of the sample is to 
allow you to observe how seiting policies changes the rate at which the message flows invoke a back-end 
program. The instructions here describe how to use the sample flows in 3 ways: 


1. Without any policy in place - the backend application will indicate that the flow is going too fast. 

2. With the maximum rate set on the BAR file - the back-end application should indicate the flow Is 
going at the rate you set. 

3. With the maximum rate set via a policy, without changing the BAR file - this should also show the 
flow going at the rate you set. 


Before you run any work through the sample, you need to ensure the back-end program is running. When 
you imported the sample, a project called Run_slow_tcpip_ app was created in your Integration Toolkit 


workspace. This contains a batch file/shell script which will launch the back-end program from a 
command prompt. 


1. Open an Integration Console by double-clicking on the desktop icon. 

2. Navigate to your Integration Toolkit workspace directory where you imported the sample 
projects — C:\workspaces\/[BWorkshop\ (or your existing directory that you are using) and 
change into the Run_slow_tcpip app subdirectory. 


Enter the following command to launch the back-end application. 
slow_tcpip_ app.bat 1445 10 


Make sure you add the parameters on the end, which are for the port (1445) and the 
maximum rate (10 messages per second). 
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3. You should see a window appear with a counter in it. The backend application should look 
like this: 


[8 Slow TCPIP application 





4. Align the counter window and the console where you started the program so that you can 
see both. 





— 4 .- 1 Ss 


C8 Slow TCPIP application - (5) x] ca.) Administrator: IBM Integration Console 9.0.0.0 - slow 
Message : 
Message 
Message 
Message 
Message 
Message r 
Message r 
Message r 
Message 
Message 
Message 
Message 
Message r 
Message r 
Message r 
Message 
Message 
Message 
Message 
Message 
Message 
Message r 
Message r 
Message 





Gn 8 8 8 oe oe oe 6 oO oO 6 oh od 6 6 6 6 6 6 oO 6 oO Oo od 
aioe aa ae a a 
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2.9 Run the application without any policy in force 


The purpose of this step is to demonsirate that without a policy, the integration node will process data too 
fast for the back-end application. Remember that the back-end application will report warnings if it is 
driven at more than 10 messages per second. 


1. A data file called WLMSample_QueryProductSalesByStores.xml is included in the 
same Run_slow_tcpip app project that contains the back-end application. This contains 
10000 records which should take around 1 minute to process on an average workstation. 


In the Integration Toolkit Application Development navigator, expand the directory 
run_slow_tcpip_app. 


Right-click on the file WLMSample_QueryProductSalesByStores.xml and select Copy. 


2 


ecRSB” 
Application Development NeW. 


(+]|AN) WLMSample_ProductSales 
El G@ BARS 

1 oa ol are ProductSales.bar -> \WLMSample_P Open 
af endeni : Open With 


New 


Rebuild) Project 





Page 12 Workload Management — Throughput Control Version 9.0.0.0 
Provided by IBM BetaWorks 


IBM Integration Bus V9.0 Workshop June 2013 


2. In Windows Explorer, navigate to C:\WLMSample directory. 


Right-click on the fileinoput subdirectory and select Paste. This will drive the application, 
because this is the input directory for the Filelnput node in the message flow. This is 
C:\WLMSample\fileinput which we configured at the beginning of the lab. 


| Bees 








GU + Computer + Local Disk (C:) + WLMSample ~ : 


Organize ~ =| Open Indudeiniibrary + Sharewith + New folder 








¢ Computer 
&, Local Disk (C:) 

1 boi Ot 
ht CVS Repository Share with 
)) pB2 cI] WinZip » 
r edipse Restore previous versions 
ry inetpub Indude in library 
r PerfLogs 


r Program Files 
J) ProgramData 
r student 

r tools 

a user 

ht Users 


kt Windows 


The directory C:\WLMSample is the root directory for the File Nodes in IIB. The file nodes 
are Filelnput and FileOutput. These nodes are in the flows that are executing. The Filelnput 
node has a property defined for the input path which is the fileinout subdirectory. The 
FileOutput node has a path property for his output directory which is the fileoutput 
subdirectory. The Filelnout node creates three subdirectories; maqsitransition for files that are 
being processed, masiarchive for completed files, and mqsibackout for files that cannot be 
processed and are backed out by the flow. 
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3. After copying the file, you should see the counter on the backend application increase, but 
the message rate is still within limits, so the counter remains green. to a large number. This 
number indicates the message rate. The background of the window will turn red and the 
console window will show messages like "Going too fast" to show that the backend 
application is being overloaded. 


Message Fr 
Message Fr 
Message r 
Message r 
Message Fr 
Message Fr 
Message Fr 


AAGQISeooo 


Message Fr 
Message Fr 














=) GeneratedBarFiles 
‘c WLMSample_ProductSalesproject.generated.bar 
=) Run_slow_tcpip_app 
1 WAS (+) jars 
ent : &) slow_tcpip_app.bat 
| slow_tcpip_app.sh 

X| WLMSample QueryProductSalesByStores. xml 








After a few seconds, you should see the counter on the backend application increase to a 
large number. This number indicates the message rate. The background of the window will 
turn red and the console window will show messages like "Going too fast" to show that the 
backend application is being overloaded. 


=) GeneratedBarFiles 
(a WLMSample_ProductSalesproject.generated. bar 
Flt Run_slow_tcpip_app 
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4. As the file is processed, you will see records added to the output file which is in 
C:\WLMSample\fileoutput \WLMSample_OutputProductSalesByStores.xml 
There should be 10000 lines added to that file once the data has been fully processed. 


Return to the Windows Explorer and open the C:\WLMSample\fileoutput directory. You will 
see the file there. 


| Biter 


GU - * Computer + Local Disk (C:) + WLMSample + fileoutput 





| Searc 





Organize * Indudeinlibrary *  Sharewith + New folder 


)) student =| ieee De 
r tools 

r user 

kt Users 

7"; Windows 

= |) WLMSample 












ha fileoutput 
| a nF | 














|) Bpternentia 


oO )s ~ Computer ~ Local Disk (C:) » WLMSample ~ fileoutput 7 [Seacrest 
Organize ~ (Open ~ New folder =: » il @ 
r Program Files «| 
}) ProgramData 
,) student 
a tools 
)) user 
?) Users 
)) Windows 
_)) WLMSample 
)) fileinput 
|. fileoutput 
OL. worksnaces 








Name + 


XML Document 
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6. The consumer application writes a “Success” or “Fail” record each record received. A 
“Success” record indicates that the message rate was within limits, but a “Fail” record was 
written when the message rate was too high and the back-end could not process due to 
overloading. 


Scroll down until you see the “Fail” records. You can see where the message rate was too 
high and a number of “Fail” records were written. 


File Edit Format View Help 








Close the Notepad window. 


You may leave the consumer window open. It will continue to produce messages saying the 
message Is ok since the producer program is not running and the message rate Is zero. 


7. When the messages are completed (message rate returns to zero), delete the 
WLMSample_ OutputProductSalesByStores.xml file in the C:\WLMSample\fileoutput 
directory. 
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2.6 Run the application with a hard coded rate limit 

This exercise shows how you can update your barfile before deployment to control workload. These 
instructions will show how a limit of 10 messages per second is imposed on the message flow which 
routes data from the file to the backend TCP/IP application. 

When the application was imported and deployed, the barfile named 

WLMSample_ProductSales.bar was generated and deployed. This barfile did not include any 
overrides to the default settings, so there was no workload limit imposed. 

You can override a property on the WLMSample_Producer message flow in the BAR editor to impose a 
Maximum Rate of 10 messages per second. 


1. Expand GeneratedBarFiles under Independent Resources. 


Right-click on the WLMSample_ProductSalesproject.generated.bar file, and click Copy. 






Quic 









Application Development Start b 
El lA [Al WLMSample_ProductSales \ 
: EB ea Flows 
, mie Fl WLMSample_ProductSales_Consumer.msgfla Open 
base pl en Open With : 
Paste 
Delete 
Move... 
EI fj jars Add Bookmark... 
ee (5) slow_tcpip_app.bat jy Import... 
2 1 slow_tcpip_app.sh 5 Fanart... 
be Rt WLMSample_QueryProductSalesByStores. xr = = 
Rebuild) Project 
Refresh 
Validate 
f 2 I oteqration Modes. 53. “ieee ee | “Bp Deploy... 
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2. Right-click on the WLMSample_ProductSales and select Paste. 


(= Flows 
Hl] BARS 
Eile Independent Resources 
Ae GeneratedBarFiles 
: be (Cg WLMSample_ Proc 
lt Run_slow_tepip app 


| Serr slow _tcpip_app. « 





Application Development 


El WLMSample_ProductSales 
AES Flows 


F] 
i L 


15 LS el el | PIL] La 


Ae GeneratedBarFiles 


= Run_slow_tcpip_app 
(> jars 
, slow_tcopip_app. bat 

= slow_tcpip_app.sh 

[x WLMSample_QueryProductSalesByStores. xml 
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Ca WLMSample_ProductSalesproject. generated, bar 


Workload Management — Throughput Control 


Manage Library references 
Fa: Manage induded projects 
‘A Focus on Application 

2 Convert to Library 


Export XSDs from Application 
Convert to Integration Bus resources ... 
-—ligrate 


Go Into 
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3. Open the newly copied barfile by double clicking on it. 


Navigate to the Manage tab in the BAR editor, and expand the application to show its 
message flows. 


Click on the Producer message flow and focus on the Properties pane. In the Properties 
pane, click on the Workload Management tab to show its properties. 


Set the Maximum Rate to 10 and save the barfile. 


(Ca = WLMSample_ProductSalesproject.generated.bar es 


Manage 


Rebuild. remove, edit, add resources to broker archive and configure their properties 





BS =) & & Filter by: | <Type filter text> = 
SB Size | Path 
| fall LMSample_ProductSales Application 30-May-2013 11:12:00 4322 
SHE] WLMSamole ProductGales Consumermsofloy Message flow S04May-2013 11:12:00 2167 


WLMSample ProductSales_Producer.msqfow | Message flow 30-May-2013 11:12:00 2583 


4 


* Command for packaging the BAR contents 





| WLMSample_ProductSales_Producer.msgflow 
“coxigue @ Workload management properties of selected built resource. 
| Workload Management | Policy 


a Notification Threshold (Messages per second) 0 







ie 





Maximum Rate (Messages per second) 





Processing Timeout (Second) [PO 
Processing Action None f 
Additional Instances fOr 
Start additional instances when flow starts TC 


Start Mode [Maintained ts | 
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4. To deploy the new barfile to the WorkloadManagement server, right-click it and select 
Deploy. 







[4 Application D en co. Patterns Exp 
| ees” 
| Application Development New...| 


(a WLMSample ProductSalesproject.ge 
Manage 


Rebuild, remove. edit. add 
E)-[A] WLMSample_ProductSales ——————aouow_auaoa>aaaa————— 
©! Flows 


AS 2) @ & Filter by: [<Typ 






[=] LA) WLMSample ProductSales 
] En WLMSample_] ProductSales 


—_—_— sr 


| oe 5 -@ ies canis i New » Ff 
El 2 — fedBarFile Se a? 
bal a WLMSample iter heer gen a 




















= Run_slow_tcpip_app = ‘ 
EI (= jars Add Bookmark... 
a fa] slow_tcpip_app.bat 
oe fi slow _tepip j app.sh e=gImport... 


ben |) WLMSample_QueryProductSalesBySto E-JExpert... 








a 52° IRR Data Source = Fy Bb puld and Save Broker archive 


Team 


Te A Miaeemcoee LAH i 





Click on the WorkloadManagement integration server and click Finish. This will replace the 
existing application. 


= iol x! 
Deploy 


Select integration server to deploy selected resources, 






Flee Integration Nodes 


E- a IBSNODE 
ae = — 
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5. Once you have deployed the updated barfile, run the same sample data file through the 
system as in the previous section. 


Hints: 
e Ensure the back-end application is still running. Restart it as before if not running. 
e Take the sample data file and copy into your fileinput directory. 


6. Observe that the backend application counter starts to change, but stays at the specified 
maximum rate (10 messages per second) rather than exceeding it as before. 


- {oj x] Alcs. tion Console 9.0.0.0 - slow_tcpip_app.bat 


BMessage rate 
aMessage rate 
Message rate 
aMessage rate 
aMessage rate 
aMessage rate 
Message rate 


aMessage rate 
Message rate 
Message rate 
Message rate 





Message rate 
BMessage rate 
Message rate 
Wessage rate 
Message rate 
Message rate 
Message rate 
Message rate 
Message rate 
Message rate 
Message rate 
Message rate 





WOO wOowoowoowomomwomwseymonseneageageg® 





7. Observe that the output file in the £1 1eo0utput folder starts to be written to. Check how long 
it takes to write the 10,000 output records to the file (it should take 1000 seconds or about 13 
minutes). 


Message 

Message r 
Message Fr 
Message r 
Message Fr 
Message r 
Message Fr 
Message Fr 
Message Fr 
Message Fr 
Message r 
Message Fr 
Message Fr 
Message r 
Message Fr 
Message Fr 
Message r 
Message Fr 
Message r 
Message Fr 





8 88 88 88 88 oe oe ee ee ee ee oe ee ee oe ee oe ee ee oe 
OW OOOO OOO OOOO ONO NOON 





| Bireetientis 


ey ‘ ) li Computer + Local Disk (c:) ~~ WLMSample = fileoutput wv ++) Search fileoutput 


Organize ~ Indudeinlibrary ~ Sharewith ~ New folder 








,) Program Files = Name - Date modified Type Size 

,) ProgramData 

r student 

)) tools 

ry user 

a Users 

)) Windows 

_)) WLMSample 
)_fileinput 

») workspaces 


G2 Z (2:) 
7 1 item 
‘ 
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8. You can experiment with setting different rate limits on the barfile. 


9. When the messages are completed (message rate returns to zero), delete the 
WLMSample_OutputProductSalesByStores.xml file in the C:\WLMSample\fileoutput 
directory. 
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2./ Run the application with an administrator-defined workload policy 


An administrator can create policies within the Integration Registry to change flow behaviour, including 
controlling the maximum rate of processing. These policies are then attached to one or more message 
flows. These can be created via the web user interface, or via commands. On the command line, a policy 
is defined via an XML file and loaded into the Integration Registry with a command, then attached to the 
flow you want to control. 


You can experiment with viewing and using policies in the Web interface as well as commands when you 
do the Web Admin lab. You can also attach different policies which specify a different rate, or change the 
policy which is already attached, and you should observe that the rate changes dynamically without the 
need to restart your broker. Note that values set in a policy override values which you specified in the 
BAR file. 


1. In Windows Explorer, navigate to C:\student\Workload_ Management\resources. 


The file WorkloadManagement_Policy.xml is the sample Workload policy from the Integration Bus 
(runtime) component installation directory. 


Copy this sample policy into the C:\WLMSample directory. Rename the file to WLMSamplePolicy.xml. 


3 WLMSample 








J) webadmin 2 ieee Date modified Type 
r webservices B cies = 
| 7 fileinput 30/05/2013 14:02 folder 
J) wMqFTe 
r werrdient r fileoutput 30/05/2013 11:45 File folder 
)) dep "| WLMSample?olicy.xml | 25/05/2013 20:59 XML Document 
ha Sb aim 


2. Open the WLMSamplePolicy.xml file with Notepad. 


| Name Date modified Type Size 
|) fileinput 30/05/2013 14:02 File folder 
)) fileoutput 30/05/2013 11:45 File folder 


23) WLMSamplePolicy. xml 25/05/2015 20:59 XML Document 









@ (Internet Explorer 
ersessehs tidio Express 2012 for Windows Desktop 
Restore previous versions “|N 






otepad 


Send to » .—)WordPad 
ak Choose default program... 
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3. 
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Locate the tag iwlm:maximumRateMsgsPerSec. Replace the default value (zero) with a new value, 
for example 20, and save your changes, and close Notepad. 





| WLMSamplePolicy.xml - Notepad 
File Edit Format View a 








<!-- Notification hreshotd - ier of messages er bins br value of zero cies the mechanism. --> 
ee ee bcd aldia —aihentirs ala naar 
: ) ; === , , =r =—=y zero disables the mechanism. --> 
is. A value of zero|disables the mechanism. --> 

iin. pr g ad -pr g 
<!-- Processing timeout action - none or “restartexecutioncroup. --> 
<iwlm: process ingTimeoutaAction></iwlm: process ingTimeoutAction> 
<!-- Additional instances - Number of additional message flow instances. --> 
<iwlm:additional Instances></iwlm:additionaliInstances> 
<!-- Start instances when flow starts - true or false. --> 
<iwlm:startInstanceswhenF lowStarts></iwlm:startInstanceswhenF lowStarts> 
<!-- Commit count - Numnber of transactions to execute before commiting. --> 
<iwlm: commi tCount></iwlm: commi tCount> 
<!-- Commit interval- Nunber of milliseconds to wait before commiting. --> 
<iwlm: comm tinterval></iwlm: commitinterval> 


<!-- Start mode - maintained, manual, or automatic --> 
<iwlm:startMode></iwlm:startMode> 
</iwlm:work]loadManagement> 
</wsp:Policy> 


In an Integration Console, navigate to c:\WLMSample (where you have just copied the new policy file). 


Create a new policy from your new file by running the command: 


mqsicreatepolicy IBYNODE 
-t WorkloadManagement 
-l1 SampleWLMPolicy 
-£ WLMSamplePolicy.xml 


Note — You can copy and paste these commands from the 
C:\student\Workload_Management\data\workload_commands.txt file. 


Attach the new policy to the WLMSample___ ProductSales_Producer flow to control the outbound 
rate to the Java application by running the command: 


mqsiattachpolicy IBYNODE 
-e WorkloadManagement 
-k WLMSample_ ProductSales 
—-m WLMSample_ ProductSales_Producer 
-t WorkloadManagement 
-l1 SampleWLMPolicy 


Stop the application 'slow_tcpip_app.bat' is if it still running. (Ctrl+C). 


Start the application with 20 rather than 10 messages/second as the maximum rate. Type in the 
command. 


slow_tcpip_ app.bat 1445 20 


Follow the previous instructions in section 2.5 to load the sample data file into the fileinput 
directory. 
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8. 


10. 
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Observe the rate at which records are sent to the Java application. This rate should match what you 
typed into the XML file in step 4. 





(5) x] ica] pacers 
Message 
Message r 
Message Fr 
Message 
Message 
Message 
Message 
Message 
Message r 
Message r 
Message 
Message 
Message 
Message 
Message 
Message Fr 
Message r 
Message 
Message 
Message 
Message 
Message 
Message r 
Message 


PA wWimsample 4 -/O) x] 
ey , ) ie = Computer v Local Disk (C:) > WLMSample = vv +>) Search WLMSample 2) 
= w il @ 
























Organize ~ || Open  Indudeinlibrary » Sharewith ~ New folder 
PY) run «| Name « Date modified Type Size 
ad soapui_projects 


ry workspace 
)) tools J) fileoutput 30/05/2013 15:02 _File folder 


, user ‘=| WLMSamplePolicy.xml 30/05/2013 14:39 XML Document 2KB 


ae Users 


a Windows 
_). WLMSample 
kim. . 


BB fileinput 30/05/2013 15:02 File folder 





As you can see, the workload management policy attached to the producer flow has throttled the 
message rate to 20 messages per second as coded in the xml policy file. 


You can experiment with viewing and using policies in the Web interface as well as commands when 
you do the Web Admin lab. You can also attach different policies which specify a different rate, or 
change the policy which is already attached, and you should observe that the rate changes dynamically 
without the need to restart your integration node. 


Important! 


Note that values set in a policy will override values which you specified in the barfile. 


When the messages are completed (message rate returns to zero), delete the 
WLMSample_OutputProductSalesByStores.xml file in the C:\WLMSample\fileoutput directory. 
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3. Controlling workload for backend applications 


This section will show how to set a maximum rate for a message flow to control the workload being 
passed to a back-end application. 


3.1. Import the Application 


1. In the Integration Toolkit, right-click in the white space of the Application Development 
navigator, and select Import. 


2. Navigate to C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_max. 


Open the Project Interchange file WLM_not_max_pi.zip. 


3. On the Import Project Interchange Contents panel, check the box for 
WLM_ notification. and_max_rate (it should already be checked). 














Click Finish. 
2 Import Project Interchange Contents | 5 [oO] x| 
Import Projects 7 
Import Projects from a zip file. | | 
= dA 
From zip file: C:\student\Workload_management\esources\WLMd *] Growse... | 
Project location root: | C:\student\Workload_management\workspace 
[= WLM_notification_and_max_rate 
Select All| Deselect All| Select Referenced | 
(?) < Back | Next » | Cancel | 
Page 26 Workload Management — Throughput Control Version 9.0.0.0 


Provided by IBM BetaWorks 


IBM Integration Bus V9.0 Workshop June 2013 


3.2 Deploy the application 


1. Select the WLM_notification_and_max_rate application and deploy it to the 
WorkLoadManagement server. 


D\ Etec] =O 





Zintatonted 5 \osasaraee) =O) renee 5 
ae fl || Pr 





Flee Integration Nodes 
El-<$] IB9NODE 


name 
«Eg, default nail 
: El, WorkloadManegement type 
a | IBSNODE? 
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2. Expand the WorkloadManagement server. 


You will see that the application has been deployed and is running as indicated by the 
upward pointing green arrow. 


EF] Properties £3 
Property 





Flee Integration Nodes 
El-<5] IBSNODE 


«Egg, default 
: Bee WorkloadManagement 
| 1k) WLM_hung_flow 
Fl Fa] WLM_notification_and_max_rate 





Expand the application also to see the artefacts which are deployed with the application. You 
will see the message flow WLM_1 and the ESQL for the WLM_1_Compute node within the 
flow. We are only concerned with the flow in this lab. 





at ff 





El-4i8 Integration Nodes 
«Ags, default 
Els WorkloadManagement 
F- Fa] WLM_hung_flow 

El FR] WLM_notification_and_max_rate 

, setae Full WLM_1 

: “-(esql WWLM_1_Compute 
ian al IBSNODE? 
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3.3 Run the application 
1. Open three DOS command prompt windows by double-clicking the icon on the desktop. 
In each command prompt window, navigate to 
C:\student\Workload_Management\resources\WLMdemo\WLM_not_and_max 
2. You will run one of three programs in each of the command windows: 


e producer of messages — produces messages as fast as possible 
consumer of message — can only consume messages at 100 messages / second 
listener for notification messages — will subscribe to topic string where notifications 
are published 


You can copy and paste the commands from the workload_commands.txt file in the 
C:\student\Workload_Management\data directory. 


3. Select one window and run the consumer program by entering the following command: 


run wlm_con.bat 


—_ tudent\Workload _management\resources \WLMdemo\WLM_not_and_max>run_wlm_con. — 


G8 Receiving application 


C:\student\Workload_management\resources\WLMdemo\WLM_not_and_max>set PATH="C:\Pr 
ogram Files ¢(x86>\IBM\IntegrationToolkit?@\jdk\bin"; "C:\Program Files ¢x86>\IBM\ 
IntegrationToolkit?@\ jdk\bin";C:\IBM\WebSphere MQ\java\1ib;C:=\Windows\system325C 
= \Windows 5C=\Windows\s ystem32\whem;C:\Windows\s ystem32\windows powershe l1l\v1.8\5c 
=<\program files\ibm\gsk8\1ib;C:\IBM\SQLLIBN\BIN;C:\IBM\SQLLIB\FUNCTION;C:\IBM\SQL 
LIB\SAMPLES\REPL;C:\IBM\WebSphere MQ\bin;C:\IBM\WebSphere MQ\tools\c\samples\bin 
>;C:\IBMNIntegrat ionToolkit?@\jdk\bin;C:\Program Files\Microsoft SQL Server\11@\T 
ools\Binn\;C:\Program Files\cusnt;C:\Program Files\IBM\Mobility Clients; 


Gs con dastoseoe 4 _management\res ources \WLMdemo\WLM_not_and_max> java -cp “ 
-\sut . japrjsorg. sutchart 4. 8. 6. .¥26126361 . jar; 70g. sutchart . ext 6.8 : 


DONT BAN COLLI BY joga\namaon, dorsGe\I Bi WebS phone “Na JavacLibtcud ibm. meine. dansCrs 
IBM\WebSphere MQ\java\lib\com.ibm.mqg.jar’ Rate_consumer 


29/65/2613 15:65 : 
22/64/2613 16:59 §99/685/2013 17:31 <DIR> 
15/63/2613 12:36 §29/05/2613 17:31 <DIR> 





The application starts up and starts receiving messages on the queue WLM.OUT1 which is 
the output queue of MQOUTPUT node in the flow is sending the messages. A running bar 
graph is displayed showing the message rate at which it is receiving messages. It will send 
error messages to alert operators that the messages are coming faster than it can handle. 


lf the producer application is not running, you may see MQ return codes 2033. This is normal 
as there are no messages in the queue until the producer starts sending. 
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4. In another window, start the listener by typing in the following command: 


run wlm list.bat 





184 wlm.mgsc 
13.855 wilm_demo_app. jar 
15/83/2813 12: 1,923 WLA_not_max_pi.zip 
18 Filets> 2,186,879 hytes 
3 °Dirés> 22,175,.436,868 bytes Free 





Co sstudent*Workload_management*resources*WLAdemo* WLA_not_and_max?run_wlm_list .b. 
t 


C:i\student*Workload_management*.resources*WLMNdemo*WLA_not_and_max?set PATH="C:\Pr 
ogram Files ¢x#6>\T BM\IntegrationToolkit?@\jdk\bin"; C2 \.1T BM WebSphere MQ\javaslib 
;C2NWindows \s ystem32 5 C= NWindows 5C:\Windows’s ystems2swhem; C:\Windows ss ystem32 win 
dows powershellsv1.6@\3co\program Files*\ibm.gsk8\1ib;C=\TBN\SQLLIB\.BIN;SC:\1BM.SGQLL 
IB\FUNCT IONS C:\IBN\SQLLIB\SANPLES*\REPL;C:\1T BM WebSphere NQ\bin;C=%] BM\Webs phere 
NQ\stoolse\c\sanples*\binsC:s\] BMI ntegrationToolkit?h\jdk\bin3sC:\Program Files*\Micr 
osoft SQL Server116\Tools*\Binns\;C:\Program Files*cvsnt5;¢:\Program Files*] BM\Mob 
ility Client’; 





C:2\student*Workload_management*.resources*VLMNdemo*WLA_not_and_max>javaw —-cp “wlm 
demo_app. jarjswt.jarj;org.swtchart_8.8 .8.u26126361. jarj;org.swtchart .ext_.8 .8.u28 
1203601 .jar;G-\TBM.SQLLIB\javasdbe java.zip;C: ST BMS8QLLI EBS javasdb2 jcc .jar;C: STEMS 
QLLIB\java’sqlj.zip;¢:%1 BM\SQLLIEB\java’db2jcc_license_cu.jar;¢:\ITBM\SQLLIB\bin3¢G 
>= SI BM.SQLL1 EB java’sconmmon.jar;G:\T BM WebSphere NO\javaslibscom.ibm.ngjms .jar;¢:s!I 
BM\WebS phere MQ \java’slibs\com.ibm.mg. jar" Rate_listener 











The listener application starts another pop-up window which shows alarms received by the 


subscription. The application will change the color from green to red if the message rate is 
too high. 


5. Inthe third window, start the producer program with the following command: 


run_wlm_prod.bat 








_ (oy x 
15:65 164 wlm.mgqsc 


bk ' 
G8 Sending application | 
16:59 13.855 wlm_demo_app. jar 


12:36 1.923 WLM_not_max_pi.zip 2 
1@ File<s> 2.188.879 bytes [iwum.ina 
3 Dirts> 22,175,436.866 bytes free 


C:\student\Workload_management\resources \WLMdemo\WLM_not_and_max>run_wlm_prod.ba 


' Message rate (messages per : 


200 
C:\student\Workload_management\resources\WLMdemo\WLM_not_and_max>set PATH="C:\Pr 

ogram Files ¢(x86>\IBM\IntegrationToolkit?@\jdk\bin";C:\IBM\WebSphere MQ\java\lib 
3;C:\Windows\s ystem32 5;C:\Windows 5;C:\Windows\s ystem32\whem;C:\Windows\s ystem32\win 

dows powershell\v1.@\3;c-\program files\ibm\gsk8\1ib;C:\IBM\SQLLIB\BIN;C:\IBM\SQLL 

I B\FUNCTION;C:\IBM\SQLLI B\SAMPLES\REPL;C:\IBM\WebSphere MQ\bin;C:\IBM\WebS phere 
MNQ@\tools\c\samples\bin;C:\IBM\Integrat ionToolkit?@\jdk\bin;C:\Program Files\Micr 

osoft SQL Server\11@6\Tools\Binn\;C:\Program Files\cusnt;C:\Program Files\I BM\Mob 

ility Client\; 


C:\student\Workload_management\resources\WLMdemo\WLM_not_and_max> java -cp “wlm_d 
eno_app. jar;.\swt.jarj;org.swtchart_6.8 .6.v26126361.jarjsorg.swtchart .ext_@.8.@.u2 
6126361 .jar;C:\IBM\SQLLIBN\ java\db2 java.zip;C:\IBM\SQLLIB\ javaN\db2 jcc. jar;C:\IBMN\ 
SQLLIB\javaN\sq1lj-zip;C:\IBM\SQLLI BN java\db2jcc_license_cu. jar;C:\IBM\SQLLIBNbin; 
C:\IBM\SGLLIB\java\common. jar;C:\IBM\WebSphere MQ\java\lib\com. ibm.mqjms.jar;C:\ 
IBM\WebS phere MQ\java\lib\com.ibm.mq. jar’ Rate_producer 
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6. Position the graphs and the alarm windows so you can see all three. 












WLM.IN1 WLM.OUT1 
a Message rate (messages per second) on Message rate (messages per second) 


[8 WLM Alarm 


Message flow name 


—— 


Alarm 


7. Notice that the alarm window is green indicating no alarms. Observe the graphs for both the 
sending application and the receiving application. 


They are very similar in that the message rate (messages per second) achieved by both 
sender and receiver are about the same. This tells you that the receiving application is 
keeping up with the sending application and is not being overloaded by the sender. 


8. Return to the Integration Toolkit and expand the Independent Resources > 
GeneratedBarFiles. 


Double-click WLM_notification_and_max_rateproject.generated.bar to open it in the edit 
pane. 


LL LLLL-->-=—ynbn>__= 
Application Development f-3 ~. ce. Patterns Explorer | = 


a 


FAS” 
Application Development NeW. 


E)-[A] WLM_notification_and_max_rate 
EE Flows 

Ed el WLM_i.msqflow 
«+ 84! ESOLs 
ETA WLMSample_ProductSales 
Fl-lff] BARS 
Ete Pasiaienieis Resources 





= (_@ WivSemple7 Productsal Eon a 
oF a Run_slow_tcpip_app 
EI © jars 
{S| slow_tcpip_app.bat 
-~|E) slow_tcpip_app.sh 
[xX] WLMSample_QueryProductSalesByStores. xml 


Page 31 Workload Management — Throughput Control Version 9.0.0.0 
Provided by IBM BetaWorks 


IBM Integration Bus V9.0 Workshop June 2013 


9. Click the Manage tab at the bottom of the editor. 


Expand the BAR file WLM_notification_and_max_rate and select the message flow 
WLM_1.msgflow. 


In its Properties pane, click Workload Management. 


(Ca WLM_notification_and_ max_rateproject.generated.bar ¢5 


Manage 


Rebuild. remove, edit, add resources to broker archive and configure their properties 














AS sf) 2B =) Filter by: | <Type filter text> a | 
[=] LA =o WLM_notification_and_max_rate aa 30-May-2013 15:29:40 3120 
feel WLM_1_ Compute. esql ESOL file 30-May-2013 15:29:40 432 
n=] WLM_i.msqflow Message flaw 30-May-2013 15:29:40 2130 


* Command for packaging the BAR contents 


Prepare) Manage | User Log | Service Log 


WLM_1.msgflow 
(1) Workidad Management Propertes OT SSlECTEO DUNT TESOUrce. 
/ Workload Management Policy 
| Details Notification Threshold (Messages per second) fO0 
Maximum Rate (Messages per second) [O00 
Processing Timeout (Second) [O00 
Processing Action [None 7 | 
Additional Instances [PO 
Start additional instances when flow starts TC 
Start Mode [Maintained * | 
Commit Count 1 
Commit Interval fO0 


Notice the properties for Notification Threshold, Maximum Rate, and Processing Timeout are 
all zero and Processing Action is None. These are the default Workload Management values 
for all message flows. 


You can review the other properties available, but we will not use those values in this lab. 
10. Workload Management properties have no effect on the message flow or processing 
applications when the default policy is used. 


From observing the sending and receiving message rates, we can see that the WLM_1 
message flow is not controlling the message rate. It will process them as fast it can. 
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3.4 Run the application with a barfile-defined message rate 


4: 
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Still working in the properties for the WLM_1.msgflow, set the values for Maximum Message Rate to 50. 





WLM_i ae 


—- 


- = 


Workload Management 
Notification Threshold (Messages per second) q 0 


Maximum Rate (Messages per second) 





Processing Timeout (Second) 0 


Processing Action [None —its—‘“—:s~—”””CC 
Additional Instances [PO 
Start additional instances when flow starts TC 

Start Mode 
Commit Count fT 
Commit Interval fo ©. 


Save the BAR file by typing Ctrl + S. 


Drag and drop the bar file onto the integration server WorkloadManagement. 


aA Application De é3 ce, Patterns Expl ~ # Ca WLM_notification_and_max_rateproject.generated.bar £3 
a — = 
=~ BS Manage 
iin edichiiitacaaa NeW. |! Rebuild, remove, edit, add resources to broker archive and configure their properties 


El [Al a“ _notification_and_max_rate 

: ae = Flows Bo sf) =) =) ‘Filter by: oo ______¥_—HSB 
fb CB WLM _i.msqflow 

re el ESQLs 








a Al WLMSample_ProductSales El LA ao WLM_notification_and_max_rate eis citte 30-May-2013 15:29:40 3120 
e- & it feel WLM_ 1. Compute.esal ESOL file 30-May-2013 15:29:40 492 
WLM_i.msaflaow Message flow 30-May-2013 15:29:40 2130 


fee (Ee WLMSample_ ProductSales. bar -> WLMSamp 
a (Ee WLMSample_ProductSalesproject.generated 
ee fe) Independent Resources 

a ees 
[[rin rotteton and man roteraet| 


be LE) WLMSample_ProductSalesproject.generz ————————— 
Ea Run_slow_tcpip_app Prepare User Log | Service Log 

I »{)) wum_a. 

| Policy PO 
Notification Threshold (Messages per second) fo © | 
Maximum Rate (Messages per second) [fo ©. | 
Processing Timeout (Second) fo ©. 
Processing Action [Nome s—<—sSS 


» Command for packaging the BAR contents 








Additional Instances | o 
_ co B WuNSonle. ProductSales Start additional instances when flow starts Oo 
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Bring the sending and receiving programs (bar graph windows) back into focus. 


Observe the message rates for both applications to see if the new Workload Management property had 
any effect. 





Di WiMt Alarm PTTeTESIOE Receiving application Ts 
Message flow name Queue name 
| # WLM.IN1 WLM.OUT 1 
” Message rate (messages per second) se Message rate (messages per second) 


100 











The sending application is still sending processing and sending messages at his normal rate, but the 
receiving application is receiving the messages at a controlled rate at a maximum of fifty messages per 
second. Over the sampling intervals the rate does not show hitting fifty, but the graph is very smooth 
indicating that the messages are arriving at a constant rate. 


Compare this to what you saw before deploying the updated BAR file. This is important to note that IIB V9 
message flows can now be configured to process at a certain rate that the back-end application can 
handle. 


Let's assume that the receiving application developers made some significant performance improvements. 
They claim that the application can now process messages at one hundred per second. But they want to 
be notified if the rate goes over the old rate of fifty messages per second. 


Return to the toolkit and the properties pane for the message flow. Change the Maximum Message Rate 
to 100 and the Notification Threshold to 50. 


(| Properties a can Probleme o= Outline 4) Tasks | FE Deployment ia 





WLM_1.msqflow 





Configure Policy 4 [| 
Workload Management = —‘otification Threshold (Messages per second) [so © | 
Details Maximum Rate (Messages per second) 100 

Processing Timeout (Second) [Oe 

Processing Action [None tt ”~<“—s~s:CY 

Additional Instances [OO 

Start additional instances when flow starts a 

Start Mode [Maintained = si(‘sésSY 

Commit Count iT : 
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Save the barfile, and redeploy using your preferred method. The changes take effect immediately. The 
integration server nor the application nor the message flow needs to be restarted. 


Bring the sending and receiving applications into focus and observe that receiving applications message 
rate has in fact increased. Again the rate is smoothed out over time and still does not show hitting 100. 





CE Sending appl cation (oO) x) ei applicatio nl -|O) x] 
Queue name Queue name 
| WLM.LIN1 | WLM, OUT 1 
Message rate (messages per second) Message rate (messages per second) 
200 200 
150 150 
100 100 





Now that you see how easy it is to change values, you can quickly test various rates and notification 
thresholds. Spend some time experimenting before closing the applications. 


When you are done experimenting, close the sending and receiving applications and the alarm application 
as well as the command prompts where you launched them. You can close the windows or enter Ctrl + C 
in the command window in which you start the application. 
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4. Subscribing to out of range message rate publications 


Integration Bus V9 publishes messages for various workload conditions. Two of those publications are 
“above threshold” alerts and “below threshold” alerts for when the message rate goes out of range or 
back into range of the Notification Threshold property set for the message flows. 


The topic strings are available for subscriptions to receive the alerts. You can define subscriptions with 
the MQ Explorer or write your own applications to subscribe to the publications for the execution groups, 
applications, and message flows which you are interested in. 


4.1 Message publication when the message rate for a message flow is out 
of range 


Once a Notification Threshold has been set for a message flow, the IIB will publish a message that the 
message rate is out of range. There are certain conditions which control the publishing of the message 
rate is out of range message. 


The message rate statistics are collected at a checkpoint that occurs every 20 seconds. The total 
message rate is calculated at this checkpoint, and if the total message rate exceeds the notification 
threshold, the out of range XML message is published. If the total message rate continues to stay above 
the notification threshold, then no further out of range messages are published. 


If you enable the notification threshold you can subscribe to the following topic: 


SSYS/Broker/<brokerName>/WorkloadManagement /AboveThreshold/<executionGroupLab 
el>/<applicationName>/<libraryName>/<messageFlowLabel> 


where brokerName is the name of the broker, executionGroupLabel is the name of the execution group 
on that broker, applicationName is the name of the application on that execution group, libraryName is 
the name of the library on that application, and messageFlowLabel is the name of the message flow that 
is deployed to the library. 


In the situation where the message flow is not contained in either an application or a library, the 
applicationName or libraryName parameters must be omitted along with their enclosing forward slash (/). 


For example: 

lf the message flow is not contained in an application and a library: 
SSYS/Broker/<brokerName>/WorkloadManagement /AboveThreshold/<executionGroupLab 
el>/<messageFlowLabel> 


If the message flow is contained in an application and not in a library: 


SSYS/Broker/<brokerName>/WorkloadManagement /AboveThreshold/<executionGroupLab 
el>/<applicationName>/<messageFlowLabel> 


For further information, refer to the IIB InfoCenter. 
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4.2 Message publication when the message rate for a message flow goes 
back into range 


When the notification threshold has been set for a message flow and the message rate exceeds the 
threshold, an out of range message Is published as described above. IIB also publishes a message when 
the message rate goes back within range (under the threshold value). There are conditions which control 
the publishing of the message rate is back in range message. 


The message rate statistics are collected at a checkpoint that occurs every 20 seconds and the total 
message rate is calculated at this checkpoint. If the total message rate previously exceeded the 
notification threshold, and then later the total message rate drops back into range, the back in range XML 
message is published. 


No state is stored when the message flow is stopped, restarted, or redeployed. When a flow is 
terminated, the flow termination process checks to see whether the last message published was to report 
that the message rate exceeded the notification threshold. In this situation, the flow termination process 
automatically publishes a message to report that the message flow is now back in range. 


If you enable the notification threshold you can subscribe to the following topic: 


SSYS/Broker/<brokerName>/WorkloadManagement /BelowThreshold/<executionGroupLab 
el>/<applicationName>/<libraryName>/<messageFlowLabel> 

where brokerName is the name of the broker, executionGroupLabel is the name of the execution group 
on that broker, applicationName is the name of the application on that execution group, libraryName is 
the name of the library on that application, and messageFlowLabel is the name of the message flow that 
is deployed to the library. 


In the situation where the message flow is not contained in either an application or a library, the 
applicationName or libraryName parameters must be omitted along with their enclosing forward slash (/). 
For example: 

If the message flow is not contained in an application and a library: 


SSYS/Broker/<brokerName>/WorkloadManagement /BelowThreshold/<executionGroupLab 
el>/<messageFlowLabel> 


where brokerName is the name of the broker, executionGroupLabel is the name of the execution group 
on that broker, and messageFlowLabel is the name of the message flow that is deployed to the execution 


group. 
lf the message flow is contained in an application and not in a library: 


SSYS/Broker/<brokerName>/WorkloadManagement /BelowThreshold/<executionGroupLab 
el>/<applicationName>/<messageFlowLabel> 


where brokerName is the name of the broker, executionGroupLabel is the name of the execution group 
on that broker, applicationName is the name of the application on that execution group, and 
messageFlowLabel is the name of the message flow that is deployed to the application. 


For further information, refer to the IIB InfoCenter. 
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4.3 Review the alerts 
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When the MQ queues and subscriptions were defined for this lab, two subscriptions were created for 
monitoring the notification threshold. The two subscriptions are WLMAT and WLMBT. Return to MQ 
Explorer and click on Subscriptions. 


4> IBM WebSphere MQ Explorer (Installation1) 
File Edit Window Help 


25. MQ Explorer - Navigator $3 \_ ss | 8) MQExplorer Content. £3. Fl Resource Statistics Graph (Waiting up to 20s for Data) | [| IBINODE Resource Statistics Table (Waiting up to 20s for 


ou’ 


=)-€:3 IBM WebSphere MQ 


| Subscriptions 


[Fiter: Standard for Subscriptions 


Wildcard usage Destinati... 





eB IBSQMGR SYSTEM.B... | SYSTEM.BROKER.ADMIN.STREAM/MO/IBSQMGR .». | Character level wildcard | IBSQMGR 





[=)RECORD.REPLAY.SUB  $SYS/Broker/IB9BROKER/Monitoring/# Topic level wildcard IBSQMGR = RECORD.RE 
SYSTEM.DEFAULT.SUB Topic level wildcard 
WLMAT $SYS/Broker /IBSNODE/WorkloadManagement/AboveThreshold/+ Topic level wildcard IBSQMGR ~—s WLM.AT 
WLMBT $SYS/Broker /IB9NODE/WorkloadManagement/BelowThreshold/# Topic level wildcard IBSQMGR = WLM.BT 
~~ Process Definitions WLMFIN $SYS/Broker /IB9NODE/WorkloadManagement/ProcessingFinished/# Topic level wildcard IBSQMGR = WLM. FIN 
~~ Yq IBNODE WLMTO $SYS/Broker /IBINODE/WorkloadManagement/ProcessingTimeout/# Topic level wildcard IBSQMGR = WLM.TO 


~~ Namelists 
-( Authentication Information 


You can see that the subscription WLMAT is receiving alert publications for the topic string 
$S YS/Broker/IB9NODE/WorkloadManagement/Above Threshold/# published by the broker. The hash 
is a wild card so it will receive “above threshold” alerts for all execution groups, all applications, and 
all message flows which have been deployed with a Notification Threshold property set. Observe the 
queue names for the subscriptions WLMAT (WLM.AT) and WLMBT (WLM.BT). The topic string is 
defined by IIB and is in a specific format. This should not be changed by users. 


Note: You may need to scroll to the right to see the Destination Queue Manager and Destination 
columns. Some columns were hidden in the screen shot below. 


4> IBM WebSphere MQ Explorer (Installation1) 
File Edit Window Help 


5, MQ Explorer - Navigator 53 = E3)| 6) MQExplorer -Content 53». Fi Resource Statistics Graph (Waiting up to 20s for Data) 


ear = 







FES IBSNODE Resource Statistics Table (Waiting up to 20s for 


sak le sare sie Subscriptions 


[Fiter: Standard for Subscriptions 


S IBSQOMGR SYSTEM.B... | SYSTEM.BROKER.ADMIN.STREAM/MQ/IBSQMGR 







Topic level wildcard IBSQMGR. 
Topic level wildcard 

$SYS/Broker /IBSNODE/WorkloadManagement/AboveThreshold/# Topic level wildcard IBSQMGR ss WLM.AT 
$SYS/Broker /IBSNODE/WorkloadManagement/BelowThreshold/# Topic level wildcard IBSQMGR =o WLM.BT 


: ‘& Process Definitions $SYS/Broker /IBSNODE/WorkloadManagement/ProcessingFinished/# Topic level wildcard IBSQMGR = WLM.FIN 
ba IBSNODE $SYS/Broker /IB9NODE/WorkloadManagement/ProcessingTimeout/# Topic level wildcard IB9QMGR_— WLM.TO 
See 
--@ Authentication Information 
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3. Click on Queues and locate the WLM* queues. 


5. MQ Explorer - Navigator 22 





Be Queue Managers 
«El AIL TBsomGR 





— [a] TRADE. COMPLETE. IN 
Eel Channels [| TRADE. COMPLETE. OUT 
~~ Telemetry [| TRADE.CUST.TYPE.IN 
ve (= Listeners =| TRADE. FIX. IN Océ 
& Services 3] TRADE.FIX.OUT Local 0 O W 
ne (= Process Definitions [3] TRADE, GOLDIN Local . : 
a IBINODE |] TRADE. GUEST.IN Local o 0 0 
~~ Namelists [| TRADE, RECONCILIATION. IN Local a 0 0 
- > Authentication Information [| TRADE.REGULAR..IN Local 0 0 0 
— (= Communication Information [| TRADE. REPLAY. INPUT Local 0 0 Q 
= (= Security Policies [| TRADE. VALIDATE. IN Local 0 0 0 
_ EG! IB9QMGR2 RADE VAI DATION. FAILURE. IN Local 0 0 ! 
ae (= Queue Manager Clusters Local 1 0 
vo [= IMS Administered Objects 5 ; Local 0 0 
~~ Managed File Transfer les) WLM.FIN Local Q 0 Q 
oH (= Service Definition Repositories [| WLM.IN1 Local 1 : 
Eig Integration Nodes IS] WLM.IN2 Local - i “ 
B-al IBSNODE a) WLM.OUT1 Local Q 1 0 
«Ag, default (S| WLM.OUT2 Local Q 0 0 


Queues 


| Filter: Standard for Queues 





= © || | mo Explorer - Content 520 FH Resource Statistics Graph (Waiting up to 20s for Data) 


June 2013 








FE] IBSNODE Resource Statist 


4. Look to see if you have any messages in the WLM.AT and WLM.BT. You should have received some 
during the above tests. If not, you may need to adjust your Notification Threshold to a lower value 
and rerun the tests. 


During my test, | received one “above threshold” alert when the value was set at twenty message per 
second. When the test hit a rate of twenty messages per second, a alert was published. Since there 
was only one alert received, the message rate stayed above twenty during most of the run. When the 
rate when below twenty, a “below threshold” alert was published. The rate did not go above twenty 
during the rest of the run since there were no more alerts. 
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5. Open RHFUtil from the Start button. 
Use the pull-down mens to populate the Queue Manager Name with IB9QMGR and the Queue 
Name with WLM.AT. 


Click Browse Q. 





File Edit Search Read Write View Ids MOQ Help 
ee : Te Prop aa : PubSub | ae : = 





| UST 


Queue Manager Name [to connect to] Q 


JIESQMGR +| IL 


Queue Name 


|WwLM.AT + | 


Remote Queue Manager Name [remote queues only] 


<<< 


Selector 


Read () | Wi ite Gl | Bronsec | Stat Browse | Browse ler | Browse Pie | End Browse 


File Code Page 


43? Ls 
le 


File h) arme Nata Size 


6. Click on the Data tab at the top of the window and click on XML under Data Format to format the 
data. 


Review the XML message which was received. The event was an “AboveThreshold”. The execution 
group is identified - WorkLoadManagement. 





File Edit Search Read Write View Ids MQ Help 
Main Data |MOMD|PS | UsrProp|RFH | PubSub| pscr | jms 
Message Data (1105) from WiL6LAT 





|other |cICS |IMS | 


UST 


Data Format 
( Character 








Lewambs revent smlns:wmb="http://www.ibm.com/xmlns/prod/websphere/messagek + 





<wmb:eventPointData> 


<wob:eventData wmb: 
<wmb:eventIidentity [wmb:eventName—" 






<wob:eventSequence wmb:creationTime=—"2013-05-31T10: 25: 15.0362" wmb: 


<wnb:eventCorrelation/ > 
</wmb:eventData> 
<wmb :mes sageFlowData> 


oroductVersion="S000" wmb:eventSchemaVersion="6.1 


( Hex 
( Both 
f* XML 
( PARSED 
‘ COBOL 
( JSON 
( Fie 
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<wmb:broker wmb:name="IBSNODE" wmb:U0UIDE"49ce557b-Sacd-470e-9c41-93 Integer Format 
<wnb $executionGroup : wmb : UUID="cb3le3f 2 PC [Intel] 
<wmb:messageFlow womb: uniqueFlowName="IBSNODE. WorkLoadManagement .WLe ( HOST (390) 
</wmb:messageFlowData> Beenie 


</wmb:eventPointData> 
<wmb:applicationData xmlns=""> 
<wnb:simpleContent wmb:name="NotificationThresholdMsgsPerSec" 


wmb:va 


f* PC [Intel] 
€ HOST (390) 


ie 


<wmb:simpleContent wmb:name—"MessageRateMsqsPerSec" womb: value="172" Char Format [lt] 
</wmb:applicationData> (© Ascii 
<,/wmb:event>  Ebedic 
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You will need to scroll to the right to see all of the fields. After scrolling right, you will see the 
Application and message flow names. You can also see the Threshold Notification value for the 
message flow and the actual message rate which caused the alert. 





File Edit Search Read Write View Ids MOQ Help 





Main Data |MOMD|PS |UsrProp|RFH |PubSub|pser |jms |usr | other |cics |IMS | 


Message Data (11705) fron W'LeLAT 
Data Format 
( Character 
( Hex 

( Both 

f* XML 

( PARSED 
( COBOL 
( JSON 
( FR 












.com/xmlns/prod/websphere/messagebroker/6.1.0/monitoring/event"> 










"9000" wmb:eventSchemaVersion="6.1.0.3" wmb:eventSourceAddress="WLM"> 
"AboveThreshold"/> 
me=—"2013-05-317T10:25:15.0362" wmb:counter—"1"/> 













»UUI DE" 4$ce557b-Sacd-470e-9c41-S3ecel1270415"/> Integer Format 
“Loaddanagement™ + rT : = 47 o— i cy Pr (Intel) 
( HOST (390) 
Packed Dec 
f* PC [Intel] 
= 
icationThresholdMsgsPerSec" womb: value—"20"| wmb:dataType="integer"/> Beigel 
geRateMsgsPerSec" wmb:value="172" womb: dataPype="integer"/> Char Format [Alt] 
lc Ascii | 
‘ame oe 
Click on the Main tab and browse the queue WLM.BT. 
File Edit Search Read Write View Ids MQ Help 
Main | Data | MOMD | PS | Usr Prop | RFH PubSub | pscr jms | usr | other 
Queue Manager Name [to connect to] Queue Type 
JIESQMGR +| [Loca 
Queue Marne 
|WwLM.BT +| 
Remote Wuwevue Manager Name [remote queues only] Save L] | 
| Load L | 
Selector 
Read () | Wi rite Gy | Bronce | Stat Browse | Browse Hert | Browse Pie | End proves Close [ 
File Code Page 
Aa? User Props 
fe As nl 
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Click on the Data tab again and review the “Below Threshold” alert. 





File Edit Search Read Write View Ids MQ Help 
Main Data |MOMD|PS | UsrProp|RFH | PubSub| pscr | jms 
Mesage Data (1106) from WfLM.BT 





|other |cICS |IMS | 


| UST 


Data Format 
( Character 
( Hex 
( Both 
f* XML 








Lewmbs revent smlns:wmb="http://www.ibm.com/xmlns/prod/websphere/messagek ~ 
<wmb:eventPointData> 
<wnob:eventData wmb:productVersion="9000" wmb:eventSchemaVersion—"6.1 






<wnb:eventidentity]wmb: eventName="BelowThreshold"/} 
. T10225255.5309982" wv 










<wmb:eventSequence wmb:creationTime— 2013-U3-3 f° PARSED 
<wmb:eventCorrelation/> COBOL 
</wmb:eventData> ( JSON 





<wmb :messageFlowData> (Fix 
<wmb: broker wob:name="IB9SNODE" womb: UUID-"49ces37b-S3acd-470e-9c41-93 Integer Format 
wnb : UUID="cb3le3f 2 PC [Intel] 
<wnb:messageFlow wob:uniqueFlowName="IBSNODE. WorkLoadManagement .WLe HOST (390) 
</wmb:messageFlowData> Serene 
</wmb:eventPointData> ‘Ole (Iritel] 
<wmb:applicationData xmlns=""> f HOST (390) 
<wob:simpleContent wmb:name="NotificationThresholdMsqsPerSec" wmb:va 





<wnb:executionGroup 





ie 


<wob:simpleContent wmb:name—"MessageRateMsgqsPerSec" wmb:value="0" wo Char Forrnat [Alt] — 
</wmb:applicationData> (* Ascii 
</wmb:event>  Ebedic 


{ Simn Chinese 


Scroll to the right to see the rest of the message. The NoticationThreshold rate is shown again, but 
now you see the message rate that caused the alert to be published that the rate was again back in 
range. This value shows zero. Remember the sampling covers a twenty second interval. 





File Edit Search Read Write View 
Main Data |MOMD| PS 
Message Data (1106) from WfLM.BT 


Ids MQ Help 
Usr Prop | RFH | PubSub | pscr jms 





| other | CICS | IMS 


UST 


Data Format 
( Character 
( Hex 
( Both 
f* XML 
( PARSED 
‘ COBOL 
( JSON 
( Fie 


Integer Format 
2 PC [Intel] 
HOST (390) 

Packed Dec 
F PC [Intel] 
wnb:dataType="intege HOST (380) 


be=—"integer"/> Char Format [lt] - 








qww.ibm.com/xmlns/prod/websphere/messagebroker/6.1.0/monitoring/event" + 







=rsion="S000" wmb:eventSchemaVersion="6.1.0.3" wob:eventSourceAddress— 
otName="BelowThreshold"/> 
ationTime—"2013-05-31T10:25:55.5309982" wmb:counter—"2"/> 







ODE” wmb: UUID—"49ce557b-Sacd-470e-9c41-93ecel1270415"/> 
ne—"WorkLoadManagement™ wmb: U0ID-"cb3lesf4-3e01-0000-0080-e3a819cesct2 
eFlowName="IBSNODE .WorkLoadManagement.WLMSample ProductSales.WLMSample 





f* Ascii 
€ Ebedic 
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Summary - Workload Management Throughput Control 


In this lab, you learned about the new Workload Management feature in IBM Integration Bus V9. You 
learned how to set properties on the message flow for monitoring the workload or message rate for 
particular. This allows system administrators to monitor and adjust the speed that messages are 
processed. 


You also learned how to set the maximum rate for a message flow to control the workload on backend 
applications. 


In addition to setting properties for message flow workload, you learned how to receive alerts from the 
Integration Bus by subscribing to specific topic strings being published base on the setting for the flows. 


This concludes the Workload Management Throughput Control lab. 
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